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SUBJECTS A generalized ready message program 

Attached to this HT8 is the description of a generalized 
reacy message command* It is a modification of the author 
maintained genera l_ready command* This new version is capable of 
printing both incremental and total values in the same ready 
message { al though the total values are per-process totals only). 
The date and time can be printed in a number of different formats 
and new 6180 Hultics quantities such as memory units, level 
numbers, etc. can also be printed. 

The new version of genera l_ready described in the attached 
MPM like description is operational, a version is available in 
>udc>R0MS>publ ic> genera !_ ready • 

One addition that has already been suggested is the 
replacement of the print messages facility with the more general 
capability of specifying a command line to be executed whenever 
the ready message procedure is invoked. 

Additional comments or suggestions should be directed to Jay 
Goloman HIT room or to Goldman. ROMS on the HIT Hultics. 
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fjameg genera l_ready, gr 

genera l_ready is a command which allows the user to set up 
a ready message containing specific values in a user specified 
format o The program is designed to allow an almost arbitrary 
format at no additional cost (relative to the system°s ready 
proceoure) other than the cost associated with the general_reaoy 
command which sets up the ready message. Once a ready message 
has been specif led* the ready^on* ready, and ready_off commands 
will control the printing of the ready message in the normal 
manner . 

genera l_ready builds up an ioa_ control string from the 
orcer of the Keywords passed to it» The keywords specify which 
values to output in the ready message. Virtual cpu usage » real 
cpu usage* and aolJar cost can be printed. 80th incremental 
usage (usage accrued since the last ready message printed by 
genera l^ready) and total usage (usage accrued during this 
process) can be printed in the same ready message with the 
precision of the output (the number of cecimal places to the 
right of the decimal point* specified by the user. 

genera l„ready -control options- -prefix options- 

- format options- 

The prefix options affect the format of the ready message but oo 
not specify the contents (the values printed) of the ready 
message. The format options specify both the contents and the 
forirat of the reacy message. The control options do not affect 
the format of the ready message, but instead control how the 
ready message and other facilities provided by genera J__ready are 
used. The prefix options must occur before any format options? 
whi le the control options may appear anywhere on the comirand 
line. 

The format ano content of the ready message is controlled by 
format optionsc These options includes keywords which identify 
values to be included in the ready message? optional arguments 
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following these keywords which control the number of digits after 
the decimal point in numeric values? and literal character 
strings which are inserted in the ready message. The format 
options are combined in the order of their appearance in the 
gen era l_ready command to form an ioa_ control string which 
controls the format of the ready message. 

Six types of values may be used in a ready message: 
processor usage values (virtual and real cpu seconds)? memory 
usage values (memory units); paging operations (both bulk store 
reaos and demand page faults)? usage cost values (dollar 
charges)? command processor level numbers? and date/time values 
(date* time of day* day of the week* etc). Both total usage 
values (total usage accrued during this process) and incremental 
usage values (usage accrued since the last ready message printed 
by genera l_ready) can be output in the same ready message* The 
values are selected for use in the ready message by the format 
keywords which are given in the command* The format keywords are 
listed below by type. 

1) processor usage values are selected from the following 
keywords. These keywords can be followed by an optional 
argument, a single numeric digit from i to 9* to indicate the 
number of digits which should appear to the right of the 
cecimal point in the number which is output. The default is 3 
cigits. The output format of the value can be described by 
the ioa_ control string ** ~..of M where £ is 3 by default. 

°ri 

-rcpui incremental real cpu value 
-rt 

-rcput total real cpu value 
-vi 

-vcpui incremental virtual cpu value 
-vt 

-vcput total virtual cpu value 

2) iremory usage values are selected by the following keywords. 
These keywords are used in the same manner as the keywords for 
processor usage values above. 

- me mor y i 
~mu i 
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-merei incremental memory units 



™memoryt 
-me ffit 

-mu t total memory units 



3) csage cost values are selected by the following keywords. 
These keywords are used in the same manner as the keywords for 
processor usage values with the following differences. The 
cefault number of digits following the decimal point is 2. 
The output format of the value can be described by the ioa_ 
control string * a $~<»nf " where u is 2 by default. 

-do I larsi 

-$i incremental cost charges 



-do I larst 

-$t total cost charges 



^ ) paging values are selected from the f o I J wing keywords. These 
keywords are output by the ioa_ control string " ~d+~d"* where 
the first number is the number of bulk store pages read 
(formerly the number of pre-pages) and the second is the 
number of demand page faults. 



-pagesi 

-pgi incremental paging values 
-pagest 

-pgt total paging values 



5) command processor level numbers are selected by the following 
keyword. This keyword indicates that the command processor 
snd stack frame level numbers should be included in the ready 
message. No optional argument may be used to control the 
number of digits. The level numbers are output by the ioa__ 
control string **~a*% but the printed format can be described 
by " level ~d,~d" where the first number is the number of 
command processor invocations and the second is the stack 
frawe depth of tne ready message procedure's stack frame. If 
the command processor level is i» the printed format is the 
nul I string. 

- level 

- I v command processor level numbers 
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6) cafe values are selected by the following keywords* These 
values can be described by the ioa control string " ~a M except 
for the -win keyword which uses the ioa control string "~a" 
(without a leading space)* No optional argument may be used 
to control the number of digits* 

-dt date and time (mm/dd/yy hhmm.m zzz www) 

-date 8 character date (mm/dd/yy) 

-hour 2 digit hour (hh) 

-minute 

-min 2 digit minute (mm) 
-t i me 

-tm 6 digit time of day (hhmtiura) 

-do w 3 character cay of week (www) 

-zone 3 character time zone (zzz) 



Note that ail values except for the number of minutes 
(-minute) are preceded by a space and none of the values are 
suffixeti by a space* Any non-keyword argument (other than a 
single numeric digit following a floating point or dollar 
keyword) is assumed to be a literal string which is inserted in 
ioa_ control string being built by genera l_ready* Refer to the 
examples below* 

£sml£&± Q&llons 

The following control options affect the operation of 
genera l_ready* but do not change the format of ready messages* 

-set causes genera l__ready to establish itself as the current 

ready message procedure* The command processor will 
then call genera l_ready to print a ready message after 
each command line is complete. In addition* the system 
commands* ready* ready_on* and ready_off* will affect 
the operation of genera l_ready. 

-reset causes general_ready to make the system ready proc the 
-rs current ready message procedure* and to reset any timer 

alarms which were established to catch shift changes* 
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~pr inf ^messages 

-prmsg when used with the -set control option, causes 
general_ready to call the print.. messages (pra) program 
before printing the ready message* This a} lows the 
user to defer messages queued by the 

ipc_message_f acil ity until each command line has 
completed execution. Any queued messages are typed 
Just before the ready tine* even if the ready_off 
command has been called to turn off ready messages* 

The -set and -reset control options are mutually exclusive. 
A general_ready command which includes -set does not print a 
reacy message. Instead, it saves the ioa_ control string built 
from the format options in the command, and uses this ioa_ string 
to control the format of ready messages printed when command 
lines complete execution or when a ready command is issued. 

A general_ready command which includes -reset prints a 
single ready message . only if format options appear in the 
command with the -reset option. Otherwise, no ready message is 
printed* 

If neither -set nor -reset is given* then general__ready 
prints one ready message according to the format options given in 
the command. 

ELgJUx Options 

There are two prefix options. These options must occur prior 
to any of the format options described above. The two prefix 
options allow the user to overrice the default formats for the 
contents of the ready message, they are* 

-string allows the user to specify the character string at 

-s the beginning of the ready message. The argument 

following this option is used instead of *V " at 
the beginning of the ready message. Since it is 
put into the ioa_ control string. **~R M and 

•*~B" may be used to cause new lines, red ribbon 
shifts and black ribbon shifts, respectively. 

-control allows the user to specify the entire ioa_ control 

-ctl string used to format the ready message. The 

string will be passed to ioa_$nnl without change 
so it must contain specifications for each of the 
various values to be included in the ready 
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message. The ioa__ control string format's for the 
various values which can be inserted into the 
ready message are given above for each type of 
value. This argument overrides any format control 
options which would normally affect the format of 
the ready message. However* format keywords must 
still be specified to indicate which values are to 
be output and the order in which these values 
correspond with the ioa_ control characters in the 
control string. 

Exaffp j es 

The following examples illustrate some of general_ready *s 
f ac i 1 i ties* 

gr -string READY -date "**xTIME -time ~xVCPU -vi -vcput -set 

The above command line establishes general^ready as the current 
reaoy procedure since the -set keyword appeared. Each ready 
message would have the format! 

READY 01/15/7% TIME 123<f. 3 VCPU 3«%56 23.3%9 

If the -set keyword had not appeared, a single ready message 
having the above format would be printed. 

The ioa_ control string which general_ready uses to generate the 
above ready message would be* 

"READY ~a~xTIHE ~a~xVCPU ~.3f ~.3f~2/" 

The command lines 

gr -s READY -date -hour t -min ~xVCPUI -vcpui ~xVCPUT 
-vcput 2 

would result in a single ready message of the form* 
READY 01/15/7% G9:%6 VCPUI 2.3%5 VCPUT 3%. 21 

using the ioa_ control strings 

"READY 'a ~a i~a~x VCPUI ~.3f~xVCPUT ~.2f~2/" 

The above ready message could have been specified by the command 
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J ines 

gr -cti "READY ~a ~as~a VCPUI ~.3f VCPUT ~.2f~2/ as -date 
-hour -min -vcpui -vcput 

The total values printed by general__ready are per-process 
totals only. Since the system does not provide usage information 
for processes other than the current process, genera l_ready can 
not obtain information about usage in prior processes. l*hen 
genera l_ready is invoked for tne first time in a process* the 
doi lar cost of ai l usage <in that process) up to that point in 
time is computed at the rates then in effect. 
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